package com.ruoyi.system.mapper;

import java.util.List;
import java.util.Map;
import com.ruoyi.system.domain.GuangDianUser;

/**
 * 广电用户Mapper接口
 * 
 * @author ruoyi
 * @date 2024-05-22
 */
public interface GuangDianUserMapper 
{
    /**
     * 查询广电用户
     * 
     * @param id 广电用户主键
     * @return 广电用户
     */
    public GuangDianUser selectGuangDianUserById(Long id);

    /**
     * 查询广电用户列表
     * 
     * @param guangDianUser 广电用户
     * @return 广电用户集合
     */
    public List<GuangDianUser> selectGuangDianUserList(GuangDianUser guangDianUser);

    /**
     * 根据用户编号查询广电用户
     * 
     * @param phoneNo 用户编号
     * @return 广电用户
     */
    public GuangDianUser selectGuangDianUserByPhoneNo(String phoneNo);

    /**
     * 根据用户地址编号查询广电用户
     * 
     * @param terminalNo 用户地址编号
     * @return 广电用户
     */
    public GuangDianUser selectGuangDianUserByTerminalNo(String terminalNo);

    /**
     * 新增广电用户
     * 
     * @param guangDianUser 广电用户
     * @return 结果
     */
    public int insertGuangDianUser(GuangDianUser guangDianUser);

    /**
     * 批量新增广电用户
     * 
     * @param guangDianUserList 广电用户列表
     * @return 结果
     */
    public int batchInsertGuangDianUser(List<GuangDianUser> guangDianUserList);

    /**
     * 修改广电用户
     * 
     * @param guangDianUser 广电用户
     * @return 结果
     */
    public int updateGuangDianUser(GuangDianUser guangDianUser);

    /**
     * 删除广电用户
     * 
     * @param id 广电用户主键
     * @return 结果
     */
    public int deleteGuangDianUserById(Long id);

    /**
     * 批量删除广电用户
     * 
     * @param ids 需要删除的数据ID
     * @return 结果
     */
    public int deleteGuangDianUserByIds(String[] ids);
    
    /**
     * 批量插入广电用户
     * 
     * @param userList 用户列表
     * @return 结果
     */
    public int batchInsert(List<GuangDianUser> userList);

    /**
     * 统计用户数量
     * 
     * @param guangDianUser 查询条件
     * @return 数量
     */
    public int countGuangDianUser(GuangDianUser guangDianUser);

    /**
     * 按标签统计用户数量
     * 
     * @param tagField 标签字段名
     * @param tagValue 标签值
     * @return 数量
     */
    public int countUserByTag(String tagField, String tagValue);

    /**
     * 查询最近N条数据
     * 
     * @param limit 数量限制
     * @return 广电用户列表
     */
    public List<GuangDianUser> selectRecentGuangDianUsers(int limit);
    
    /**
     * 查询最近更新的用户数据
     * 
     * @param limit 查询数量
     * @return 用户数据列表
     */
    public List<GuangDianUser> findRecentData(int limit);
    
    /**
     * 获取用户总数
     * 
     * @return 用户总数
     */
    public long count();
    
    /**
     * 根据标签统计用户数量
     * 
     * @param params 参数Map，包含tagField和tagValue
     * @return 符合条件的用户数量
     */
    public long countByTag(Map<String, Object> params);
}